跳到主要内容

添加集成

让我们从添加第一个集成开始。在本教程中,我们将使用 Workday 集成。它可以用于基于工作日、休息日或假期进行自动化。本教程不需要任何智能设备。

先决条件

本教程假设您已经安装了 Home Assistant 并至少完成了入门步骤

添加集成

  1. 转到设置 > 设备和服务

    • 集成页面显示您已经安装的所有集成。其中一些是自动安装的。
    • 如果在您的网络中发现了设备,您将在已发现部分看到它们。 Screenshot of the integrations page, with discovered devices
  2. 如果为您发现了任何设备,您现在可以添加它们。

  • 已发现下,选择集成上的添加
  • 如果需要额外配置,请按照 UI 中的步骤操作。
  • 如果没有发现设备,不用担心,我们将在下一步添加一个集成。
  1. 在右下角,选择添加集成

  2. 输入 workd 并选择 Workday 集成。 Screenshot of the add integrations dialog

  3. 给它一个名称,例如 Workday tomorrow,并选择国家。

  • 国家用于确定当地的假期。
  • 选择提交,然后完成。
  1. 配置选项。
  • 例如,如果周一不是您的工作日,选择"x"将其移除。
  • 要检查明天是否是工作日,在偏移下输入 1
  • 根据需要填写所有其他选项。至少需要定义假期语言
  • 选择提交Screenshot of the configuration options
  1. 选择区域,例如办公室,然后选择完成

  2. 您现在在列表中看到 Workday 集成。

    • 恭喜!您已添加了第一个集成。任务完成。 Screenshot of the workday integration on the integrations page

查看集成详情

  1. 选择集成。 Screenshot of the workday integration on the integrations page
  • 这将打开集成详情页面。
  • 我们看到这个集成有一个服务和一个实体。
  • 文档打开此集成的文档页面。
  • 已知问题打开 GitHub 问题跟踪器,筛选出与此集成相关的问题。
    • 这允许您查看其他用户是否报告了与该集成相关的问题。
  • 启用调试日志让您激活该集成的调试日志Screenshot of the workday integration details page
  1. 选择服务,打开服务信息页面。
  • 日志中,您可以看到该传感器的时间线。
  • 传感器下,您可以看到集成提供的所有传感器。这里,我们只有一个,但如果您有气候设备,例如,您可能会在这里看到温度、湿度和电池状态。
  • 您还可以看到 Workday 尚未在任何自动化、脚本或场景中使用。 Screenshot of the workday sensor info page
  1. 选择返回按钮 。然后,选择实体打开实体列表。
    • 尽管您的 Home Assistant 已经有许多实体,您在实体表中只看到 1 个条目。
    • 这是因为它是过滤的
    • 您可以看到实体 ID,它由域(设备类型的技术术语)和实体名称组成,格式如下:domain.entity_name

Screenshot of the entities list, filtered for workday

修改集成

  1. 要更改名称,选择三个点 菜单,然后选择重命名。 Screenshot of the entities list, filtered for workday
  2. 您还可以添加另一个 Workday 传感器。例如,如果您想知道同事何时有假期。
  • 选择添加条目,给它一个名称并定义您的选项。
  • 选择感兴趣的国家。
  1. 就是这样!
  • 您已经了解了集成页面的概览,并知道在哪里可以找到集成详情页面、传感器信息页面和实体表。
  • 您已经学会了重命名、修改和删除集成。
  • 如果您想找到更多集成,请查看集成文档
  • 我们现在准备在自动化中使用 Workday